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1.0  SCOPE 

1.1  IDENTIFICATION  '  -j 

The  Linking  Loader  is  one  of  three  software  units  that  comprise  the  RP-16  micro¬ 
processor's  basic  relocatable  assembler/loader .  The  overall  software  package  has  been 
assigned  Raytheon  control  number  TBD  .  This  document  is  assigned  as  a  designator. 
CG-  TBD  consistent  with  Technical  Standards  3  and  3050.  The  authorized  abbrevi  t 
for  this  loader  package  is  Raytheon  Macro  Assembler  Link  Loader  or  RAMA  Link  Loa  er. 

1.2  FUNCTIONAL  SUMMARY 

The  Linking  Loader  Specification  is  one  of  three  development  specifications.  The 
first  specification,  Raytheon  Macro  Assembler  for  the  RP-16,  CG-  TBD  .defines  the 
organization  of  the  load  module  text  for  either  absolute  or  relocatable  code. 

This  document  specifies  the  functional  characteristics  of  the  RAMA  Linking  Loader. 
The  Linking  Loader  is  a  program  which  inputs  load  modules  in  RAMA  Reiocatable  Object 
Text  format  and  stores  them  in  RP-16  memory.  It  is  capable  of  loading  modules  starting 
at  a  location  specified  by  the  operator,  linking  modules,  and  outputting  a  load  map. 

|  2 . 0  APPLICABLE  DOCUMENTS 

|  The  following  documents,  of  the  exact  issue  shown,  form  a  part  of  this  specif ica- 

I  tion  to  the  extent  specified  herein: 

i 

|  RP-16  Microprocessor  Manual  (blue  book) 

Raytheon  Macro  Assembler  for  the  RP-16  Functional  Specification,  CG-  TBD 

RAMA  (pie-  obji&iJr  . . . _ . ... 


3.0  REQUIREMENTS 

3.1  SYSTEM  PERFORMANCE 

The  RAMA  Linking  Loader  shall  be  basically  a  set  of  subroutines  with  distinct  entry 
points  that  are  basic  to  the  overall  load/link/map  process  of  a  loader  for  relocatable 
code.  These  individual  subroutines  shall  be  controlled  by  a  basic  operating  system  to 
load ' object  text.  The  loader  shall  be  written  such  that  it  will  accommodate  a  variety 
of  load  module  source  devices  such  as: 


High  Speed  Paper  Tape  (IOC) 
Teletype  (IOC) 

Floppy  Disk 
Standard  Disk 


Magnetic  Tape 
Cassette  Tape 
Punched  Cards 


Subroutines  for  I/O  control  of  those  devices  noted  as  IOC  (Initial  Operational 
Capability)  shall  be  accomplished  as  part  of  the  basic  loader. 
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3.2.1  EQUIPMENT  CONFIGURATION 

The  loader  shall  operate  on  a  system  consisting  as  a  minimum  of: 

a)  RP-16  Microprocessor  c)  Teletype  or  Equivalent 

b)  2K  of  Memory  d) '  High  Speed  Paper  Tape  Reader 

3.2.2  SOFTWARE  CONFIGURATION 


The  linking  leader  subroutines  shall  operate  in  conjunction  with  a  basic  operating 
system.  This  basic  operating  system  shall  be  controlled  by  operator  entry  of  commands 
via  teletype  (or  equivalent)  and  in  turn  shall  call  the  required  subroutines  of  the 
Linking  Loader.  The  teletype  controlled  operating  system  shall  be  written  as  part  of 
the  IOC  software  package  for  the  hardware  configuration  of  3.2.1. 


3.2.3  INTERFACES 

All  access  to  peripheral  devices  shall  be  by  way  of  I/O  subroutines.  Provisions 
shall  be  made  for  a  simple  addition  of  I/O  device  drive  routines  into  the  Linking 
Loader  package. 


3.3  FUNCTIONAL  REQUIREMENTS 

The  RP-16  Linking  Loader  is  a  program  which  inputs  load  modules  in  RP-16  Relocatable^— 
Object  Text  format  and  stores  them  in  memory.  It  is  capable  of  loading  modules  starting 
at  a  location  specified  by  the  operator,  linking  modules,  and  outputing  a  load  map. 


The  Loader  is  written  in  RP-16  assembly  language  and  is  loaded  by  bootstrapping  it 
into  memory  either  with  the  PIN  card  or  the  absolute  binary  loader.  It  is  coded  such 
that  it  can  be  loaded  and  executed  starting  at  any  memory  location.  It  will  run  in  an 
RP-16  with  either  double-word  or  byte  instruction  sets. 

The  basic  loader  is  written  as  a’  set  of  subroutines  with  distinct  entry  points  for 
performing  each  of  five  functions.  All  I/O  operations  are  performed  by  external  calls 
to  an  I/O  interface  routine. 


3.3.1  LOADER  COMMANDS 


The  loader  command  functions  are  Set  Bias  Location,  Initialize  and  Load,  Load  and 
Link,  Output  Map,  and  Start  program.  The  entry  points  corresponding  to  these  functions 
are  respectively:  L.BIAS,  L.LOAD,  L.LINK,  L.MAP,  and  L.GO. 

3.3.1. 1  Set  Bias  Location 

A  subroutine  call  to  L.BIAS  causes  the  loader  to  set  the  bias  location  for  loading 
the  next  program  to  the  value  in  the  A- register.  The  calling  sequence  is 

JSUB  (=L.BIAS) 

JUMP  error  error  return  location 

normal  return  location 


If  the  A-register  contains  an  address  taken  up  by  the  loader,  an  error  return  will  be 
made.  r 
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3.3. 1.2  Initialize  and  Load 

A  subroutine  call  to  L . LOAD  causes  the  loader  to  clear  its  symbol  table  and  load  • 
one  program  module.  The  calling  sequence  is: 

JSUB  (=L.LOAD) 

JUMP  error  error  return  location 

normal  return 

If  a  loading  error  is  encountered,  the  loader  will  perform  an  error  return  with  the 
error  code  in  the  A-register.  The  error  codes  and  their  meanings  are: 

1  checksum  error 

2  sequence  number  error 

3  illegal  item  type 

4  attempt  to  load  over  the  loader  or  symbol  table 

5  /ockcI  ^rrcr 

3.3. 1.3  Load  and  Link 

A  subroutine  call  to  L.LINK  causes  the  loader  to  load  one  program  module  without 
initializing  the  symbol  table.  The  calling  sequence  is: 

JSUB  (=L.LINK) 

JUMP  error  error  return  location 

normal  return  location 

If  a  loading  error  is  encountered,  the  loader  will  perform  an  error  return  with  the 
error  code  in  the  A-register.  The  error  codes  are  the  same  as  listed  in  Section  3 . 3 . 1 . 2 . 

3. 3. 1.4  Output  Map 

A  subroutine  call-  to  L.MAP  causes  the  loader  to  output  the  symbol  table.  The 
calling  sequence  is: 

•  # 

JSUB  (=L.MAP) 

The  symbol  table  is  first  sorted  by  symbol  name,  then  output  with  a  separate  line  per 
symbol  name  and  its  value.  Undefined  symbol  names  are  output  with  a  preceding  asterisk 
and  a  value  equal  to  the  last  reference  location.  The  last  line  of  the  map  contains 
the  next  available  load  location. 

3.3. 1.5  Start  Program 

A  subroutine  call  to  L.GO  causes  the  loader  to  perform  a  jump  to  the  address  con¬ 
tained  in  the  A-register  if  it  is  non-zero.  Otherwise,  it  will  jump  to  the  location 
specified  by  the  last  item  type  0E  encountered  in  the  object  text.  The  calling  sequence 
is : 

JSUB  (=L.GO) 


3.3. 1.6  Loader  Operation 

The  loader  builds  its  symbol  table  starting  with  the  memory  location  immediately 
preceding  its  first  instruction  and  expanding  it  toward  lower  memory.  Each  entry  point 
or  undefined  external  reference  causes  a  new  entry  to  be  added  to  the  symbol  table. 

The  maximum  amount  of  object  text  that  can  be  loaded  depends  on  the  amount  of  memory 
available  and  the  number  of  external  names  used.  ... _ _ _ _ 
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The  loader  performs  I/O  operations  by  doing  subroutine  calls  to  an  I/O  interface 
package.  Objyt  text  is^by  exerting  the  folding  callrng  seg^ce: 

TSTTR  (~1  .  BINI) 


JSUB  (=1 . BINI) 
DATA  1 


return  location 


The  first  word  in  the  buffer  contains  the  value  80]_o  followed  by  40  words.  The  map  is 
output  by  performing  the  following  calling  sequence  for  each  line  output: 

-/4  fixe  attire}*  >«  /}-  -  rtysfar' 

JSUB  (=I.C0UT) 

DATA  2 

return  location 


The  first  word  of  the  buffer  contains  the  count  of  the  number  of  bytes  to  be  output 
followed  by  the  text  in  8-bit  ASCII  characters. 


4.0  QUALITY  ASSURANCE 


5 . 0  PREPARATION  FOR  DELIVERY 
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APPENDIX  I 


OBJECT  CODE  ITEM  TYPES 


00  -  Null  Item  (1  byte) 


01 

02 

03 

04 


05 

06 

07 

08 

09 

OA 

OB 

OC 

OD 


OE 

OF 


FF 


Entry  Point  Name  (f  'bytes) 

Name  -  8  bytes  left  justified 

Absolute  Program  Origin  (3  bytes) 

Location  -  2  bytes 

Relocatable  Program  Origin  (3  bytes) 
Location  -  2  bytes 

Fill  Data  (5  bytes) 

Word  Count  -  2  bytes 
Data  -  2  bytes 

16-bit  Absolute  Data  (3  bytes) 

Data  -  2  bytes 

16-bit  Relocatable  Data  (3  bytes) 

Data  -  2  bytes 

Absolute  Location  (3  bytes) 

Location  -  2  bytes 

Relocatable  Location  (3  bytes) 

Location  -  2  bytes 

Entry  Point  Definition  (9  bytes) 

Name  -  &  bytes 

External  Link  Pointer.  (//  bytes) 

Name  -  Q  bytes 
Offset-  2  bytes 

Internal  Link  Pointer  16-bits  (3  bytes) 
Offset  -  2  bytes 

Internal  Link  Pointer  8-bits  (3  bytes) 
Offset  -  2  bytes 

Variable  Length  Data  (2  x  Count  +  1  bytes) 
Word  Count  -  1  byte 
Data  -  2  x  Count  bytes 

Transfer  Address  (1  byte) 

/ 

Program  Name  ( *?  bytes) 

Name  -  S,  bytes 

End  of  Load  Module  (1  byte) 


